home *** CD-ROM | disk | FTP | other *** search
/ The Utilities Experience / The Utilities Experience - Volume 1.iso / software / graphics / a-g / flick_1_4 / flick.doc < prev    next >
Encoding:
Text File  |  1995-12-21  |  10.6 KB  |  337 lines
  1.  
  2.         FLICK FLI-format Animation Viewer v1.4           5 Jan 1995
  3.         --------------------------------------
  4.  
  5.  
  6. This program plays FLI/FLC-format bitmapped animation files on any
  7. OCS, ECS, AGA or EGS Amiga running OS2.04 or higher.  FLI/FLC-format
  8. files are produced by Autodesk Animator (Pro) and Autodesk 3D Studio
  9. on a PC, as well as by other programs.
  10.  
  11. The files in this archive may be distributed anywhere provided they are
  12. unmodified and are not sold for profit.
  13.  
  14. Ownership and copyright of all files remains with the author:
  15.  
  16.     Peter McGavin, 86 Totara Crescent, Lower Hutt, New Zealand.
  17.     e-mail: peterm@maths.grace.cri.nz
  18.  
  19.  
  20. FEATURES:
  21. ---------
  22.  
  23. Supports EGS Spectrum and other third-party graphics cards via EGS
  24. libraries.  Runs in a draggable, overlappable window in this case.
  25.  
  26. Uses AGA 256-colour screen when AGA is available.
  27.  
  28. Extra-Half-Brite screen (EHB) allows reasonably good colour
  29. approximation on OCS/ECS Amigas.
  30.  
  31. 16-colour screen (COLOUR4) allows reasonably good colour approximation
  32. on OCS/ECS Amigas in hires (and it's usually faster than 256-colour).
  33.  
  34. Falls back to EHB (lores) or COLOUR4 (hires) when EGS or AGA are not
  35. available.
  36.  
  37. Uses an Intuition-friendly Screen.  You can flip it to the back, or
  38. drag it down in the usual way, while an animation is playing.
  39.  
  40. Plays either from ram or directly from disk.  Falls back to disk play
  41. when not enough ram is available.
  42.  
  43. Works with any size or resolution FLI/FLC file.
  44.  
  45. Supports double-buffering.  The latest OS3.0 double-buffering
  46. functions are used if possible.
  47.  
  48. Uses state-of-the-art chunky-to-planar routines.  Achieves typically
  49. 90 frames/second in WARP mode on an A4000/040.  Detects and uses Akiko
  50. chip on CD32 for typically 40 frames/second.
  51.  
  52. Uses ASL file-requester.
  53.  
  54. Runs from either icon or shell.  Uses icon tooltypes for options (i.e,
  55. WorkBench Icons/Information... menu item).
  56.  
  57. Source code is included, so if something doesn't work you can fix it.
  58.  
  59.  
  60. OPERATION:
  61. ----------
  62.  
  63. I've tried to make it easy to use in many different ways.
  64.  
  65. Just double-click the FLICK icon and select an anim to play from the
  66. requester.
  67.  
  68. Alternatively you can set up project icons for your anims (e.g, with
  69. IconEdit).
  70.  
  71. Options can be specified either on the commandline or via icon
  72. tooltypes.
  73.  
  74. From the SHELL or CLI, the syntax is:
  75.  
  76.    FLICK FILE/M,DISK/S,RAM/S,ONCE/S,COLOUR/S,EHB/S,COLOUR4/S,GREY/S,
  77.          EGS/S,ROM/S,DBUF/S,WARP/S,NOAKIKO/S
  78.  
  79. If you don't specify a file, the file-requester pops up.
  80.  
  81. You can specify a list of files, separated by spaces.  However #?
  82. wildcards don't work.
  83.  
  84. Options are:
  85.  
  86.     DISK:        Plays from disk (i.e, plays while reading).
  87.  
  88.     RAM (default):    Plays from RAM (i.e, loads first, then plays).
  89.  
  90.     ONCE:        Play once, then quit.  (Default is to loop).
  91.  
  92.     COLOUR (default): AGA 8-bitplane 256-colour mode.
  93.  
  94.     EHB:        Extra-Half-Brite 6-bitplane mode.
  95.  
  96.     COLOUR4:    4-bitplane 16-colour mode (usually faster).
  97.  
  98.     GREY:        4-bitplane 16-grey-scale mode (usually fastest).
  99.  
  100.     EGS:        3rd-party graphics card via EGS libraries.
  101.  
  102.     ROM:        Uses graphics.library WritePixelArray8().
  103.  
  104.     DBUF:        Double-buffer.  Default is not to double buffer.
  105.  
  106.     WARP:        Plays real fast.  Default speed is what anim says.
  107.  
  108.     NOAKIKO:    Do not use Akiko even if it is available
  109.  
  110. The options COLOUR, EHB, COLOUR4, GREY and EGS are mutually exclusive.
  111.  
  112. The ROM and DBUF options may be used in conjunction with COLOUR, EHB,
  113. COLOUR4 or GREY, but they have no effect with EGS.
  114.  
  115. The ROM option might be useful with non-EGS 3rd-party graphics cards,
  116. via mode-promotion.  Without the ROM or EGS options, FLICK writes
  117. directly to the Screen's bitmap, which might crash with some cards.
  118. The ROM option makes FLICK 100% RTG friendly.
  119.  
  120.  
  121. KEYBOARD AND MOUSE CONTROLS
  122. ---------------------------
  123.  
  124. To quit an animation, press ESC, Q, q or CTRL/C, or click the right
  125. mouse button.  (In EGS mode, the right mouse button must be clicked
  126. inside the window.)
  127.  
  128. Keys F1 through F10 can be used to change the speed as follows:
  129.  
  130.    F1   as fast as possible
  131.    F2   60 frames per second
  132.    F3   30 frames per second
  133.    F4   24 frames per second
  134.    F5   15 frames per second
  135.    F6   12 frames per second
  136.    F7   10 frames per second
  137.    F8   5 frames per second
  138.    F9   1 frame per second
  139.    F10  at rate specified in FLI/FLC file
  140.  
  141. The + and - keys can also be used to speed up and slow down an
  142. animation while it is playing.  Each press doubles or halves the
  143. current requested speed.
  144.  
  145. Note: If FLICK cannot run as fast as the requested speed, you may have
  146. to press - several times before you see any slowdown.
  147.  
  148.  
  149. USING EGS LIBRARIES
  150. -------------------
  151.  
  152. FLICK tries to open a window on the default EGS screen if EGS
  153. libraries are installed and no overriding options are given.
  154.  
  155. FLICK requires an 8-bit EGS screen.  If the default EGS screen is
  156. 24-bit or another depth, FLICK gives up on EGS and falls back to
  157. COLOUR, EHB and COLOUR4 in that order.
  158.  
  159. To prevent that from happening, either:
  160.  
  161.   o  Change the default EGS screen to depth-8 with EGS-ScreenMode
  162.      Prefs; or
  163.  
  164.   o  Define the FLICK environment variable as the name of a valid
  165.      EGS screen mode, e.g, SETENV FLICK "LEGSa:VGA 640x480".
  166.      FLICK will then open a new screen using that mode, instead
  167.      of using the default EGS screen.
  168.  
  169. EGS Speed is dependent on the EGS driver installed.  A GVP Spectrum
  170. card is very fast.  The Amiga AGA driver is very slow.  If your EGS
  171. libraries are installed with the AGA driver, use the COLOUR option or
  172. tooltype to request an Amiga screenmode.
  173.  
  174.  
  175. OTHER FREELY DISTRIBUTABLE FLI PLAYERS FOR THE AMIGA:
  176. -----------------------------------------------------
  177.  
  178. Other FLI viewers I know about are:
  179.  
  180.     Flit 1.0 by John Bickers.
  181.  
  182.     AmiFlick v1.05 by Garrick Meeker.
  183.  
  184.     Flip 1.66 by Dominik Tonn.
  185.  
  186.     EGSFlick 1.2 by Frank Neumann
  187.  
  188. These should all be available on Aminet or orion.etsu.edu.  Flip v1.66
  189. is often faster than FLICK v1.3, but it requires AGA.
  190.  
  191.  
  192. WHY IS IT SO SLOW?
  193. ------------------
  194.  
  195. Have you tried the WARP option or pressed F1 yet?  The default is to
  196. play at the speed defined in the anim file, which is usually slow.
  197.  
  198. Have you got EGS libraries installed with the AGA driver?  That will
  199. be very slow.  Disable EGS (e.g, by moving the EGS monitor icon to
  200. storage and rebooting) or use the COLOUR option or tooltype with
  201. FLICK.
  202.  
  203. EGSFlick 1.2 is faster than FLICK because EGSFlick decompresses all
  204. the frames into RAM first.  FLICK saves memory by decompressing on the
  205. fly.
  206.  
  207. Well actually I think FLICK is quite fast for what it does.
  208.  
  209. FLI-format is exactly the wrong format for the Amiga.  That is,
  210. everything is stored internally in "chunky" format, but the Amiga has
  211. its graphics video-memory arranged in "planar" format.  All known
  212. algorithms to convert between chunky and planar format are very, very
  213. slow.
  214.  
  215. FLICK incorporates several different c2p algorithms optimised for
  216. different situations.  All the routines are now CPU based.  There are
  217. separate c2p routines optimised for the 68000, 68020, 68040 and Akiko.
  218. All c2p routines attempt to update only parts of the display that
  219. changed since last time.
  220.  
  221. If you manage to improve the algorithms significantly, or find a
  222. faster one, please let me know.
  223.  
  224. For EHB, COLOUR4 and GREY modes, the program makes an extra
  225. translation for every pixel.  In EHB and COLOUR4 modes the program
  226. performs a long calculation to recompute the translation table every
  227. time the colour map changes.  (Note: FLICK does not recalculate the
  228. currently displayed frame with the new palette, so if the next frame
  229. changes only part of the screen then the part which is unchanged will
  230. appear in the wrong colours.  Fortunately this doesn't happen very
  231. often, and it never happens in COLOUR mode on an AGA Amiga.)
  232.  
  233. If you really want to see a FLI-format or FLC-format file played fast,
  234. convert it to an Amiga anim format first.  The shareware program
  235. MainActor is excellent for that.  Also AmiFlick can write IFF files,
  236. and some of the commercial anim utilities, like ImageFX, can convert
  237. directly from FLI to anim.
  238.  
  239.  
  240. BUGS:
  241. -----
  242.  
  243. Bugs?  What bugs?  Oh well, maybe the following can be construed as bugs:
  244.  
  245. Anims with lots of colour map changes don't play correctly in EHB,
  246.     GREY or COLOUR4.
  247. Can't select multiple files from file requester.
  248. Can't use #? wildcards on commandline.
  249. Stdio output window is ugly.
  250.  
  251.  
  252. THANKS:
  253. -------
  254.  
  255. Thanks to James McCoull for his c2p routines (which I have modified
  256. slightly).
  257.  
  258. Thanks to Patrick van Logchem, Dominik Tonn, John Bickers and others
  259. for suggestions and testing.
  260.  
  261.  
  262. DISCLAIMER:
  263. -----------
  264.  
  265. It seems to work for me.  Tested on:
  266.  
  267.     A3000 + 40MHz Warp engine + Spectrum EGS
  268.     A4000/040
  269.     A500 + Mega Midget Racer
  270.     CD32 + SX-1
  271.  
  272.  
  273. HISTORY:
  274. --------
  275.  
  276. v1.0   19 Dec 1993
  277.  
  278. First release.
  279.  
  280.  
  281. v1.1   27 Jan 1994
  282.  
  283. Fixed some minor bugs (missing "break" statements which fortunately didn't
  284.     do any harm apart from wasting some memory).
  285. Fixed bug where some structures could be left allocated and asl.library
  286.     left open after certain error conditions.
  287. Use V39 Intuition-friendly double-buffering functions when possible.
  288. Added ROM option to use graphics.library WritePixelArray8().
  289. Significantly sped up the chunky2planar routine.
  290. Got FLC-format support working for 640x480 and 480x300 resolutions.
  291. CTRL/C aborts the whole program, not just return to the file requester.
  292. Added 68040-optimised c2p routine.
  293. Added COLOUR4 mode.
  294. Compiled with SAS/C 6.51.
  295.  
  296.  
  297. v1.2   19 Feb 1994
  298.  
  299. Fixed bug where mode did not fall back to COLOUR4 for FLC files on ECS
  300.     Amigas.
  301. Worked around SAS/C 6.51 bug in fseek/fread that caused some disk
  302.     anims to fail.
  303. Disk-play now reads a frame at a time instead of a chunk at a time.
  304. Improved c2p routine for Chip-only machines by eliminating a mem copy.
  305. Fixed bug where dbuf messages weren't replied to after strange error
  306.     conditions.
  307. Added support for FLI/FLC files of any resolution.
  308. Wrote a much faster routine for when only part of the display changes
  309.     each frame (and made it the default).  This sped up many anims
  310.     by a factor of 2 or more.
  311. Added NOCOMPARE and NODBUF options.
  312.  
  313.  
  314. v1.3    4 Jan 1995
  315.  
  316. Changes almost too numerous to list.
  317. Replaced all c2p routines with new, much faster, OCS-friendly ones.
  318. Removed NOCOMPARE option, no longer uses blitter at all.
  319. Added support for EGS libraries, run in a window.
  320. Added + and - keyboard controls.
  321. Default is now single-buffered instead of double-buffered.
  322. Added exact-speed feature and WARP option.
  323. Right-mouse button quits.
  324. Auto-detect and use Akiko chip.
  325. Rewrote some of the chunk decoding routines in assembly.
  326. Added tooltype support.
  327. Greatly sped up code for ROM option.
  328. For ROM option, allocate bitmap in more system friendly way for gfx cards.
  329. Major code restructuring in general.
  330.  
  331.  
  332. v1.4    5 Jan 1995
  333.  
  334. Fixed bug which sometimes caused crashes when double-buffering.
  335. Fixed bug which caused corrupted displays with Akiko and depth < 8.
  336. Added NOAKIKO option (handy for comparing speeds on a CD32).
  337.